How Do I Upgrade Ghost

This tutorial show you how to upgrade Ghost in the Shell/SSH on the Cloud Clusters platform.

Note: For security reasons, only the accounts have passed our verification will be granted permission to the Shell / SSH service. If you would like to enable it, please update your billing information. Our staff will finish verifying your information within 2 hours.

1. Locate the application

Log in to the Client Panel and locate your target deployment on the Home page or the My Applications page.

2. Take a full backup

Before any changes, it's a good idea to make frequent backups, so if anything goes wrong, you’ll still have all your data. Please refer to the guide on how to take a system backup.

3. Navigate to the "Shell / SSH" page

Click the "Manage" button on the Home page or the My Applications page. Then Click the "Shell / SSH" tab in the menu bar.

On the Shell / SSH page, you can see a "Connect" button, which is only open to the accounts that has passed our verification process for security reasons. To update your billing account information, please log in to the client panel.

Click the Connect button to initiate a shell session. You can issue commands in it.

4. Upgrade Ghost

Go to ghost directory to check current Ghost Version.

cd /cloudclusters/ghost
gosu ghostadmin ghost version

Issue the following command to upgrade Ghost to a certain version.

gosu ghostadmin ghost update `target version` 

Please replace target version with a specific version. For example,

 gosu ghostadmin ghost update 5.24.2

If you do not specify a version, then Ghost is upgraded to the latest version.

Once the upgrade completes, check the version again using the command.

 gosu ghostadmin ghost version

5. Update configuration files

View all the Ghost files using the ll command.

You can see that the files associated to the previous versions are kept under the versions directory.

Then, back up the new configuration files and make sure that ghostadmin has the same files permissions on new configuraiton files as it has on previous configuration files.

For configuration file - defaults.json

mv /cloudclusters/ghost/versions/5.24.2/core/shared/config/defaults.json /cloudclusters/ghost/versions/5.24.2/core/shared/config/defaults.json.bak
cp -a /cloudclusters/ghost/versions/5.23.0/core/shared/config/defaults.json /cloudclusters/ghost/versions/5.24.2/core/shared/config/

For configuration file - config.development.json

mv /cloudclusters/ghost/versions/5.24.2/core/shared/config/env/config.development.json /cloudclusters/ghost/versions/5.24.2/core/shared/config/env/config.development.json.bak
cp -a /cloudclusters/ghost/versions/5.23.0/core/shared/config/env/config.development.json /cloudclusters/ghost/versions/5.24.2/core/shared/config/env/config.development.json

After this, you can run ll to check if ghostadmin has the file permissions to these new configuration files. If no, grant the permissions to ghostadmin using the following command.

chown ghostadmin:ghostadmin /cloudclusters/ghost

6. Make the upgrade effective

Restart the service so the upgrade can take effect.

supervisorctl restart ghost

That's it. You've upgrade your Ghost successfully.